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A method and system in accordance with the present inven- 
tion allows the help information to be shared independent of 
its invocation method, so that the information can be dis- 
played in both integrated user assistance mechanisms and 
traditional online help windows. The method includes 
receiving an invocation of one of a plurality of user assis- 
tance mechanisms; and collecting help information from an 
information source, the information source comprising a 
structure indicating what portion of the information source 
is to be displayed based upon the invoked user assistance 
mechanism. With a method and system in accordance with 
the present invention, help authors place a metastructure or 
secondary structure in the information source. This second- 
ary structure indicates which parts of the information source 
should be displayed by that particular integrated user assis- 
tance mechanism. A method and system in accordance with 
the present invention reads the information source and 
secondary structure and then takes the information defined 
by the secondary structure and passes it to the integrated user 
assistance mechanism to be displayed. For example, the 
same text information can be retrieved from one source and 
displayed in the following three places — a traditional online 
help window, inline text in a software dialog, inside a pop-up 
window over a control. With the method and system in 
accordance with the present invention, the author only has to 
maintain one source, so that both the integrated user assis- 
tance mechanism and the traditional online help will contain 
the accurate information. 
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First Step: Specify a name for your new database. 

This SmartGuide will help you create and tailor a 
new database. To create a basic database, enter 
a new name, select a drive, and click on Done. If 
you want to tailor the database to your 
requirements, click on Next to continue. 
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First Step: Specify a name for your new database. 

This SmartGuide will help you create and tailor a 
new database. To create a basic database, enter 
a new name, select a drive, and click on Done. If 
you want to tailor the database to your 
requirements, click on Next to continue. 
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manager. 

Type a name for the new database. The name: 
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□ New database name 

Database names are the identifiers assigned to databases in the 
database manager. These names must be unique within this 
database manager. 



Type a name for the new database. The name; 

• Must contain 1 to 8 characters 

• Must begin with one of the letters A through Z 
(uppercase or lowercase), or @, #, or $ 

• Can include the letters A through Z (uppercase 
or lowercase), the digits 0 through 9, and @, #, 
$, and _ (underscore) 

Note: To avoid potential problems, do not use the special 

characters @, #, and $ in a database name if you intend to 
use the database in a communications environment. Also, 
because the characters @, #, and $ are not common to all 
keyboards, do not use them if you plan to use the 
database in another country. 

□ Default drive or directory 



Unless you override the default drive, the User Tables, Catalog 
Tables, and Temporary Tables will be stored here. The database 
configuration file and the database recovery log will also be stored 
here. 
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<A NAME="SPTCRDB_NAME_CTL"x/A> 
<P> 

<B><IMG SRO'/pbulletgif ALT="Figure pbullet not displayed." x/B> <B>New database 
name</B> 

<P>Database names are identifiers assigned to databases in the database manager. These names must 
be unique within this database manager. 

<P>Type a name for the new database. The name: 

<UL COMPACT 

<Ll>Must contain 1 to 8 characters 

<Ll>Must begin with one of the letters A through Z (uppercase or lowercase), 
or @, #, or $ 

<Ll>Can include the letters A through Z (uppercase or lowercase), the digits 0 through 9, and @, #, $, 
and _ (underscore) 

</UL> 

<PxA NAME="SPTCRDB_NAME_MOREV/A> 

<TABLE><TRXTD ALIGN=1EFI* VALIGN=TOI^<B>Note:</Bx/rDxTD 
ALIGN="LEFT VALIGN=70PVro avoid potential problems, do not use the special characters & 
#, and $ in a database name if you intend to use the database in a communications environment. Also, 
because the characters @, #, ana $ are not common to all keyboards, do not use them if you plan to use 
the database in another country. 

</TD></TR></TABLE> 

<A NAME="SPTCRDB_DRIVE_CTL"x/A> 

<P> 

<BxIMG SRC=".pbttlletgir ALT=*Figure pbullet not displayed.*></B><B>Default drive or 
directory </B> 

<P>Unless you override the default drive, the User Tables, Catalog Tables, and Temporary Tables will 
be stored here. The database configuration file and the database recovery log will also be stored here. 
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METHOD AND SYSTEM FOR DELIVERING dent of its invocation method, so that the information can be 

INTEGRATED USER ASSISTANCE displayed in both integrated user assistance mechanisms and 

INFORMATION AND TRADITIONAL HELP traditional online help windows. The method includes 

FROM THE SAME SOURCE receiving an invocation of one of a plurality of user assis- 

5 tance mechanisms; and collecting help information from an 

This application claims the benefit of provisional appli- information source, the information source comprising a 

cation Ser. No. 60/131,107 filed Apr. 26, 1999. structure indicating what portion of the information source 

Ffci n op thp iMVPKrnnM ^ t0 ^ e displayed based upon the invoked user assistance 

ritiLL/ ut j tit iin vtiiN 1 turs mechanism. With a method and system in accordance with 

The present invention relates to a computer system and 10 the present invention, help authors place a metastructure or 

method for delivering integrated user assistance information secondary structure in the information source. This second- 

and traditional help from the same source in such a system. ary structure indicates which parts of the information source 

BACKGROUND OF THE INVENTION should be displayed by that particular integrated user assis- 
tance mechanism. A method and system in accordance with 

A method and system in accordance with the present is the present invention reads the information source and 

invention is a method that allows the same information secondary structure and then takes the information defined 

source to be shared and used for both integrated user by the secondary structure and passes it to the integrated user 

assistance and traditional online help, regardless of its assistance mechanism to be displayed. For example, the 

invocation method. same text information can be retrieved from one source and 

The term "user assistance" is used to describe mecha- 20 displayed in the following three places — a traditional online 

nisms that help users use a product more efficiently. Things help window, inline text in a software dialog, inside a pop-up 

that fall into this category are books (hardcopy and online), window over a control. With the method and system in 

wizards, online help, screen prompts, labels for graphical accordance with the present invention, the author only has to 

user interface (GUI) controls, and messages. The term maintain one source, so that both the integrated user assis- 

" integrated user assistance" is used to describe the mecha- 25 tance mechanism and the traditional online help will contain 

nisms that deliver assistance to users within software prod- the accurate information, 
uct dialogs themselves. In a software application, these are 

examples of integrated user assistance: wizards, inline text BRIEF DESCRIPTION OF THE DRAWINGS 

(single and multi-line text within the product dialogs), hover „ T „ . . „ . . , , 

help (text boxes that appear relative to GUI controls), and 30 / IG 1 * " ? OW ^ hart a preferred embodiment 

pop-up windows (text boxes that appear over fields and °! * me ° th f a ? ow ?. th ? Same mformatlOD source t0 be 

controls in response to user action). Lastly, the term, "tra- shared independently of its invocation method m accordance 

ditional online help" in a software application is used to wUh me presCnt mwnton - 

describe that information that is usually displayed in a FIG - ? illustrates a first dialog box in accordance with the 

window separate from the software application dialogs and 35 P resent invention. 

is typically invoked when the user clicks a Help button. FIG. 3 illustrates a second dialog box in accordance with 

A method and system in accordance with the present me present invention, 

invention allows the same textual information or a subset of FIG. 4 illustrates a help online window in accordance with 

the information to be displayed by both integrated user the present invention. 

assistance mechanisms (for example, in a pop-up window or 40 FIG. 5 shows the source files for the information shown 

as inline text) and the traditional online help window. in FIG. 4. 

Conventionally help authors have to store the exact same r ir • , fl „„, <, . t , . ., 

. r *- • i_ iL 'i ^ "G. 6 is a now chart illustrating in more detail the 

information in two separate physical sources. One source ^ _ 1 ^ . ,• «. e t * A c *u * n iL 

fil , , . . . r y / , , , . , , preterred embodiment of a method for that allows the same 

tile would contain the information to be loaded when the • * *• * L L • j j ^ * • 

4 . ' , - " ~r Ae information source to be shared independently of its mvo- 

mtegrated user assistance mechanism is invoked and the 45 - . , . , - tU , . 

tU & 4 . . . _ , . cation method m accordance with the present invention, 
other source file would contain the same information to be 

loaded when the traditional online help window is invoked DETAILED DESCRIPTION 
(typically by pressing a Help button). The problem is that the 

author has to continuously ensure that the information in The present invention relates to a method that allows the 
both physical places is the same at all times and keep the 50 same information source to be shared and used for both 
sources in sync. If the help author fails to update both integrated user assistance and traditional online help, regard- 
physical places with updated information, the user will see less of its invocation method. The following description is 
different information that purportedly describes the same presented to enable one of ordinary skill in the art to make 
thing, depending on whether he invokes the integrated user and ^ thc ; invention and is provided in the context of a 
assistance mechanism or the traditional online help. In this 55 patent application and its requirements. Various modifica- 
situation, the user would not be able to tell which one held tions t0 tne preferred embodiment and the generic principles 
the accurate information. The duplication also increases and features described herein will be readily apparent to 
storage requirements. ^ose skilled in the art. Thus, the present invention is not 
Accordingly, what is needed is a system and method for intended to be limited to the embodiment shown but is to be 
allowing a user to minimize the need to store the same 60 accor ded the widest scope consistent with the principles and 
information in multiple sources. The system and method fcatu res described herein. 

should be easy to implement and cost effective. The present terr n "user assistance" is used to describe mecha- 

invention addresses such a need. nisms that help users use a product more efficiently. Things 

SUMMARY OF THE INVENTION ^ ^ ^ ^ Categ ° fy m b00kS ( hardco Py and online )> 

summary 1 iiN vhn 1 1UIN 65 onlioe help ^ prompts and meS sages. Also for 

A method and system in accordance with the present this discussion, the term "integrated user assistance" is used 

invention allows the help information to be shared indepen- to describe the mechanisms that deliver assistance to users 
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within software product dialogs themselves. In a software Thus, the pop-up window 302 for the new database name 
application, these are examples of integrated user assistance: field 202 displays a chunk of the information (from "Data- 
wizards, inline text (multiline text within the product base names are ..." to (underscore)") from the source while 
dialogs), hover help (text boxes that appear over graphic the online help window 402 shows all the information from 
icon buttons), and pop-up windows (text boxes that appear 5 tb e so Urce ( more information about the new database name 
over fields and controls in response to user action). Lastly, field 2 02 as well as information about other controls in the 
for this discussion, "traditional online help" m a software window 204, e.g., default drive or directory control). 

application is used to describe that information that is ™_. . .. , . 

usually displayed in a window separate from the software ™ e m y entl0n acmeves ^sresult or behavior by looking 

application dialogs and is typically invoked when the user at the information source and the secondary structure that 

clicks a Help button. 10 nas Deen mar ked within the source. The marking can be done 

A method and system in accordance with the present b y ™ author or k can be automated. For this case, the 

invention allows the same textual information or a subset of secondary structure is made up of two markers: a marker that 

the information to be displayed by both integrated user indicates the start of the information for each chunk and a 

assistance mechanisms (for example, in a pop-up window or marker that indicates the end of the information for each 

as inline text) and the traditional online help window. 1S chunk - In the preferred embodiment, target-less anchors are 

FIG. lis a flow chart illustrating a preferred embodiment UJ * d as markers. FIG. 5 shows the source file for the 

of a method for that allows the same information source to information in FIG. 4. 

be shared independently of its invocation method in accor- Io FI 9 5 ' ^ c ma . rkcr indicating the beginning of the 

dance with the present invention. First, the invention 2Q information to be displayed in the pop-up for the new 

receives an invocation of one of a plurality of user assistance database name field is: 

mechanisms, via step 102. User assistance mechanisms <A NAME»"SPTCRDB_NAME__CTL"x/A> 

include, but are not limited to, integrated user assistance The marker indicating the end of the information to be 

mechanisms and traditional online help windows. Next, help displayed in the pop-up is: 

information is collected from the information source, via 2$ <a NAME="SPTCRDB_NAME_MORE"></A> 

step 104. The information source can include, but is not The marker indicating the beginning of the information to 

limited to, files, entries in a database, and entities compiled be displayed in the pop-up for the next control, the default 

or compressed from an original source. The information drive or directory control is: 

source contains a structure which indicates what portion of < ^ NAME-"SPTCRDB DRIVE CTL"x/A> 

the information source is to be displayed based upon the 3Q s when field . level " hel to mvok * d for a particu- 

invoked user assistance mechanism^ TTien, the collected help ^ comrol ^ invQnXioQ obtains from a ^ m& ^ 

information is displayed, via step 106. name of ^ information source which contains the help 

A method and system in accordance with the present information for the current dialog 204 and the name of the 

invention allows the help information to be shared indepen- associ ated marker for the particular control. This invention 

dent of its invocation method, so that the information can be 35 looks through me mformalion ^nrce for a start marker 

displayed in both integrated user assistance mechanisms and a aame ^ me mn1ml (herC) « xxxxxC TL") and 

traditional online help windows. With a method and system an end markef ^ a Qame foUowing a spec ified format 

m accordance with the present invention, help authors place (herc> « xxxxx _MORE"), takes the text that lies in the 

a metastructure or secondary structure in the information between those ^ markers and displays it ^ the 

source. This secondary structure indicates which parts of the 40 p 0 p_ U p window 

information source should be displayed by that particular FIG. 6 is a flow chart illustrating in more detail the 

integrated user assistance mechanism. A method and system preferred embodiment of a method that allows the same 

in accordance with the present invention reads the informa- m f ormatio n source to be shared independently of its invo- 

tion source and secondary structure and then takes the cation method ^ accordance ^ih the present invention, 

information defined by the secondary structure and passes it 45 First> the mvention obtairjs the Dame of me information 

to the integrated user assistance mechanism to be displayed. for ^ current dialog? yia stcp m ^ information 

For example, the same text mformation can be retrieved for ^ cxample aDove ^ ^ filc 502 displayed in 

from one source and displayed in the following three FIG. 5. The name of the start marker associated with the 

places— a traditional online help window, inline text in a control is also obtained, via step 604. For the pop-up help for 

software dialog, inside a pop-up window over a control. 50 me new data base name field 202, the start marker name is 

Here is an example of bow a method and system in "STCRDB„NAME_CTL M . The information source 502 is 

accordance with the present invention works. In this then read to find the start marker, via step 606. Once found, 

example, the description of the new database name field 202 me invention collects the help information after the start 

inside the application dialog 204 illustrated in FIG. 2 is marker until the end marker is reached, via steps 608 and 

displayed in both a pop-up window and in a traditional help 55 610. For the pop-up help for the new database name field 

window, while the text of the description itself is contained 202, the help information chunk collected would be the 

in a single HTML file. information between the markers <A NAME="STCRDB_ 

When the focus is in the new database name field 202 and NAME_CTL"x/A> and <A NAME="STCRDB_ 

the user presses the Fl key two (not shown), a pop-up NAME_3*ORE"x/A>. Then, the collected help informa- 

window 302 appears that displays information about what so tion is displayed, via step 612, as illustrate in FIG. 4. 

the user can enter for a name in this field, as shown in FIG. When the Help button 206 is pressed in the dialog 204 to 

3- invoke the traditional online help window 402, the whole 

When the user presses the Help button 206 (FIG. 2), the information source 502 is displayed. Therefore, in this 

traditional online help window 402 displays the information example, with a method and system in accordance with the 

about all controls on this dialog page 204, including the 65 present invention, the help author only has to write and 

information about the new database name field 202, as update the information in one source that can be used in both 

shown in FIG. 4. pop-up help and traditional online help. 
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One can think of this secondary structure as a "transpar- 
ency** overlaid on top of the full information source, and this 
transparency "highlights** the information content to be used 
within a particular integrated user assistance mechanism. 
Multiple layers of transparencies may be used for multiple 5 
user assistance mechanisms, for example to "highlight' 1 
information that is not a simple linear subsection. These 
multiple layers allow the mechanism to recursively highlight 
a section within a section. A method and system in accor- 
dance with the present invention goes through the informa- 
tion source, and using the secondary structure, determines 1 
which information is "highlighted" ,for a particular inte- 
grated user assistance mechanism, and provides the indi- 
cated information to the mechanism to be displayed. 

Although the present invention is described in the context 
of an information source in the HTML format, one of 15 
ordinary skill in the art will understand that other markup 
languages may be used without departing from the spirit and 
scope of the present invention. For example, well known 
XML and SGML formats may also be used. Further, markers 
other than anchor tags may be used. 20 

Although the present invention has been described in 
accordance with the embodiments shown, one of ordinary 
skill in the art will readily recognize that there could be 
variations to the embodiments and those variations would be 
within the spirit and scope of the present invention. 1S 
Accordingly, many modifications may be made by one of 
ordinary skill in the art without departing from the spirit and 
scope of the appended claims. 

What is claimed is: 

1. A method for providing help information, comprising 
the steps of: 

(a) receiving an invocation of a first user assistance 
mechanism or a second user assistance mechanism, 
wherein the first user assistance mechanism is a differ- 
ent type of mechanism than the second user assistance 
mechanism; 35 

(b) collecting help information from a single integrated 
information source, the information source comprising 
a structure indicating that a first portion of the infor- 
mation source is to be displayed if the first user 
assistance mechanism is invoked and that a second 40 
portion of the information source is to be displayed if 
the second user assistance mechanism is invoked, 
wherein the first portion is a subset of the second 
portion; and 

(c) displaying the first portion of the information source if 45 
the first user assistance mechanism is invoked and 
displaying the second portion of the information source 

if the second user assistance mechanism is invoked, 
wherein the first portion is displayed without first 
displaying the second portion, and wherein the second 50 
portion is displayed without first displaying the first 
portion. 

2. The method of claim 1, wherein the first or second user 
assistance mechanism comprises at least one of: 

wizards; 
inline text 
hover help 
pop-up window; and 

traditional online help. go 

3. The method of claim 1, wherein the information source 
is in a markup language format. 

4. The method of claim 1, wherein the collecting step (b) 
comprises: 

(bl) finding a start marker associated with the invoked 65 
user assistance mechanism in the information source; 
and 



55 



(b2) collecting the help information until an end marker is 
reached. 

5. The method of claim 4, wherein prior to the finding step 
(bl) comprises: 

(bli) obtaining a name of the information source for a 

current dialog; and 
(blii) obtaining a name of the start marker. 

6. A computer readable medium with program instruc- 
tions for providing help information, the instructions for: 

(a) receiving an invocation of a first user assistance 
mechanism or a second user assistance mechanism, 
wherein the first user assistance mechanism is a differ- 
ent type of mechanism than the second user assistance 
mechanism; 

(b) collecting help information from a single integrated 
information source, the information source comprising 
a structure indicating that a first portion of the infor- 
mation source is to be displayed if the first user 
assistance mechanism is invoked and that a second 
portion of the information source is to be displayed if 
the second user assistance mechanism is invoked, 
wherein the first portion is a subset of the second 
portion; and 

(c) displaying the first portion of the information source if 
the first user assistance mechanism is invoked and 
displaying the second portion of the information source 
if the second user assistance mechanism is invoked, 
wherein the first portion is displayed without first 
displaying the second portion, and wherein the second 
portion is displayed without first displaying the first 
portion. 

7. The medium of claim 6, wherein the first or second user 
assistance mechanism comprises at least one of: 

wizards; 

inline text 

hover help 

pop-up window; and 

traditional online help. 

8. The medium of claim 6, wherein the information source 
is in a markup language format. 

9. The medium of claim 6, wherein the collecting instruc- 
tion (b) comprises instructions for: 

(bl) finding a start marker associated with the invoked 
user assistance mechanism in the information source; 
and 

(b2) collecting the help information until an end marker is 
reached. 

10. The medium of claim 9, wherein prior to the finding 
instruction (bl) comprises instructions for: 

(bli) obtaining a name of the information source for a 

current dialog; and 
(blii) obtaining a name of the start marker. 

11. A method for providing help information, comprising 
the steps of: 

(a) receiving an invocation of a first user assistance 
mechanism or a second user assistance mechanism, 
wherein the first user assistance mechanism is a differ- 
ent type of mechanism than the second user assistance 
mechanism; 

(b) obtaining a name of a single integrated information 
source for a current dialog; 

(c) obtaining a name of a start marker associated with the 
invoked user assistance mechanism; 

(d) finding the start marker in the information source; 
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(e) collecting help information until an end marker is 
reached, wherein the collected help information com- 
prises a first portion of the information source if the 
invoked user assistance mechanism is the first user 
assistance mechanism, wherein the collected help 5 
information comprises a second portion of the infor- 
mation source if the invoked user assistance mecha- 
nism is the second user assistance mechanism, wherein 
the first portion is a subset of the second portion; and 

(f) displaying the collected help information, wherein the 10 
first portion is displayed without first displaying the 
second portion, and wherein the second portion is 
displayed without first displaying the first portion. 

12. The method of claim 11, wherein the first or second 
user assistance mechanism comprises at least one of: 15 

wizards; 
inline text 
hover help 
pop-up window; and 
traditional onlined help. 

13. The method of claim 11, wherein the information 
source is in a markup language format. 

14. A computer readable medium with program instruc- 
tions for providing help information, the instructions for: 25 

(a) receiving an invocation of a first user assistance 
mechanism or a second user assistance mechanism, 
wherein the first user assistance mechanism is a differ- 
ent type of mechanism than the second user assistance 



mechanism; 



20 



30 



(b) obtaining a name of a single integrated information 
source for a current dialog; 

(c) obtaining a name of a start marker associated with the 
invoked user assistance mechanism; 

(d) finding the start marker in the information source; 35 

(e) collecting help information until an end marker is 
reached, wherein the collected help information com- 
prises a first portion of the information source if the 
invoked user assistance mechanism is the first user 
assistance mechanism, wherein the collected help 40 
information comprises a second portion of the infor- 
mation source if the invoked user assistance mecha- 
nism is the second user assistance mechanism, wherein 
the first portion is a subset of the second portion; and 

(f) displaying the collected help information, wherein the 45 
first portion is displayed without first displaying the 
second portion, and wherein the second portion is 
displayed without first displaying the first portion. 

15. The medium of claim 14, wherein the first or second 
user assistance mechanism comprises at least one of: 50 

wizards; 
inline text 
hover help 
pop-up window; and 
traditional online help. 

16. The medium of claim 14, wherein the information 
source is in a markup language format. 

17. A memory structure containing program instructions 
for providing help information, the instructions for: 60 

(a) receiving an invocation of a first user assistance 
mechanism or a second user assistance mechanism, 
wherein the first user assistance mechanism is a differ- 
ent type of mechanism than the second user assistance 
mechanism; 65 

(b) collecting help information from a single integrated 
information source, the information source comprising 



55 



a structure indicating that a first portion of the infor- 
mation source is to be displayed if the first user 
assistance mechanism is invoked and that a second 
portion of the information source is to be displayed if 
the second user assistance mechanism is invoked, 
wherein the first portion is a subset of the second 
portion; and 

(c) displaying the first portion of the information source if 
the first user assistance mechanism is invoked and 
displaying the second portion of the information source 
if the second user assistance mechanism is invoked, 
wherein the first portion is displayed without first 
displaying the second portion, and wherein the second 
portion is displayed without first displaying the first 
portion. 

18. The structure of claim 17, wherein the first or second 
user assistance mechanism comprises at least one of: 

wizards; 

inline text 

hover help 

pop-up window; and 

traditional help. 

19. The structure of claim 17, wherein the information 
source is in a markup language format. 

20. The structure of claim 17, wherein the collecting 
instruction (b) comprises instructions for 

(bl) finding a start marker associated with the invoked 
user assistance mechanism in the information source; 
and 

(b2) collecting the help information until an end marker is 
reached. 

21. The structure of claim 20, wherein prior to the finding 
instruction (bl) comprises instructions for: 

(bli) obtaining a name of the information source for a 

current dialog; and 
(blii) obtaining a name of the start marker. 

22. A memory structure containing program instructions 
for providing help information, the instructions for: 

(a) receiving an invocation of a first user assistance 
mechanism or a second user assistance mechanism, 
wherein the first user assistance mechanism is a differ- 
ent type of mechanism than the second user assistance 
mechanism; 

(b) obtaining a name of a single integrated information 
source for a current dialog; 

(c) obtain a name of a start marker associated with the 
invoked user assistance mechanism; 

(d) finding the start marker in the information source; 

(e) collecting help information until an end marker is 
reached, wherein the collected help information com- 
prises a first portion of the information source if the 
invoked user assistance mechanism is the first user 
assistance mechanism, wherein the collected help 
information comprises a second portion of the infor- 
mation source if the invoked user assistance mecha- 
nism is the second user assistance mechanism, wherein 
the first portion is a subset of the second portion; and 

(f) displaying the collected help information, wherein the 
first portion is displayed without first displaying the 
second portion, and wherein the second portion is 
displayed without first displaying the first portion. 

23. The structure of claim 22, wherein the first or second 
user assistance mechanism comprises at least one of: 

wizards; 
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inline text 24. The structure of claim 22, wherein the information 

hover help source is in a markup language format, 
pop-up window; and 

traditional online help. * * * * * 
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